<hl><b>Note: </b>This help file was created for advanced users of Pinnacle Software products who need to create their own help files.
</hl>
The PommelScan program searches one or more directories for files with a particular wildcard pattern. It displays a menu of the files it found, which can then be viewed.
Normally, the files will use Pinnacle Software's <a href="#POMMELOV">Pommel</a> markup language, but an ordinary text file also works ù provided you leave a blank space between paragraphs.
<H2>Command-line Parameters</H2>
PommelScan recognizes the following command-line parameters.
Directories listed in the /D parameter must be separated by semicolons. For example:
<hl>
/D"c:\My Files;c:Inventory;d:Test"
</hl>
As shown above, if the parameter following a switch contains spaces, it must be enclosed in quotes.
If you turn Pommel mode off (/P-), PommelScan can be used as an ordinary text-file browser. Normally, though, Pommel mode is <b>on</b>, which means that PommelScan will display files with word-wrap enabled, and will process Pommel markup tags.
"Pommel" stands for "Parse-O-Matic Markup-Enhanced Language". It is primarily designed to be used in-house by Pinnacle Software for the rapid creation of help files for <a href="http://www.parse-o-matic.com">custom applications</a>.
You may wish to use some features of Pommel in Help files you create for Pinnacle Software products (such as Advanced Scripting in <a href="http://members.aol.com/getmydata/pc-sample.htm">TextHarvest</a>).
The most basic form of Pommel is a simple text file with blank lines between paragraphs. If you do not wish to learn about markup tags, this is really all you need to know about Pommel.
<h2>Pommel Tags</h2>
Pommel is similar to HTML. It recognizes many of the same symbols. However, if you have coded in HTML before, there are a few differences to bear in mind:
<hl>
ù Blank lines are treated as such; they are not ignored
ù Markup tags cannot be used across line-breaks
ù Heading tags (e.g. H1) must be closed (e.g. /H1)
ù There is a maximum of one anchor tag per displayed line
ù Tag attributes must be in "quotes"
ù Files will be displayed in a fixed-pitch font
</hl>
Here are the tags that Pommel recognizes:
<hl>
ùùù ùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùù-
Tag Description
ùùù ùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùù-
A Anchor (explained </hl><a href="#ANCHORTG">below</a><hl>)
B Bold
I Italic
FS Font scale (explained </hl><a href="#FONTSCTG">below</a><hl>)
H Heading (H1 to H4)
HL Highlight (different text color)
U Underline
ùùù ùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùùù-
</hl>
Tags must be explicitly closed (example: /H1), with the exception of the anchor tag with the <hl>name</hl> attribute.
Pommel recognizes several standard HTML symbols, such as ampersand-copy-semicolon. Here are the symbols Pommel knows:
The pommel:// and file:// features have a maximum nesting level of one. That is to say, a Pommel file can open up another Pommel file in a new window, but if that window attempts to open another file, it will replace itself.
Both the pommel:// and file:// attributes look for the vertical bar (a.k.a. pipe) character after the file name. If it is found, the text following it is used as the title of the new window, in lieu of the file name. Click <a href="file://Help-PommelScan.txt|This is the HRef-Embedded Title">here</a> to see this in action.
<a name="FONTSCTG"><H3>The Font Scale Tag</H3>
This tag accepts an X attribute to indicate the size of the following text relative to the standard size. For example, X="0.5" indicates half-sized text.
<fs X="0.9">This text is 90% normal size (X="0.9")</fs>
<fs X="1.2">This text is 120% normal size (X="1.2")</fs>
To return to normal text, use the /FS tag.
<h2>Miscellaneous Tips</h2>
While viewing a Pommel file via PommelScan's file viewer, you can press F5 to refresh the display. After refresh, the file viewer attempts to reposition itself at the spot where your cursor was last located. This feature lets you develop a Pommel file in a text editor and view the results immediately after saving.
When PommelScan is searching for files, it examines the first 100 lines of each one to see if it can find an H1 tag. If it finds one, it uses the heading as the title in the list of topics.
<h2>Legal Notices</h2>
PommelScan<fs x="1.5">™</fs> and Pommel<fs x="1.5">™</fs> are trademarks of Pinnacle Software.<fs x="0.75">
The entire product (comprising software, documentation and supporting provisions) is presented as-is; we make no claim about (and disavow liability for) its suitability, accuracy, reliability, performance etc. If you should encounter a problem with the product, please <a href="mailto:info@parse-o-matic.com">write to us</a> to find out if a solution is available.
